home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / palert16.arc / PALERT.DOC < prev    next >
Text File  |  1987-01-17  |  12KB  |  360 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   P A L E R T
  17.  
  18.                                        by
  19.  
  20.                                  Norm Patriquin
  21.  
  22.  
  23.  
  24.                                    Version 1.6
  25.                                   January  1987
  26.  
  27.  
  28.  
  29.  
  30.                        Support BBS --  Patriquin's BBS
  31.                                        714-369-9766 (DATA)
  32.  
  33.  
  34.  
  35.  
  36.                        Copyright 1987 by Norm Patriquin
  37.  
  38.  
  39.  
  40.                         Table of Contents
  41.  
  42.  
  43.       What is PALERT. . . . . . . . . . . . . . . . . . . . . .   1
  44.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  45.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  46.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
  47.       Registering PALERT. . . . . . . . . . . . . . . . . . . .   7
  48.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  49.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  50.       Other Utilities . . . . . . . . . . . . . . . . . . . . .   9
  51.                                                                 Page  1
  52.  
  53.       What is PALERT
  54.       --------------
  55.  
  56.       PALERT is a utility program to help you avoid unexpectedly
  57.       running out of disk space.  Many times application programs
  58.       terminate abnormally or disallow you from completing a function
  59.       because of insufficient disk space.  Sometimes, this may
  60.       cause you to lose valuable work time and sometimes causes data
  61.       to be lost. PALERT watches your disk space and warns you when
  62.       space is getting low.
  63.  
  64.       PALERT lets you specify your disk space needs and then watches
  65.       the disk until that limit is reached.  It then warns you of
  66.       the situation and lets you take appropriate action.  PALERT
  67.       is implemented as a standard DOS command that may be used
  68.       by itself or from a DOS batch command file.
  69.  
  70.       Implement PALERT before starting any application or program
  71.       where sufficient disk space is critical.  PALERT will save
  72.       you time and money.
  73.  
  74.                                                                 Page  2
  75.       Features:
  76.       ---------
  77.  
  78.         **  Checks space whenever you want to.
  79.  
  80.         **  Can trigger other commands based on insufficient
  81.             disk space.
  82.  
  83.         **  Many features to customize messages and actions
  84.  
  85.         **  Easy to install and use
  86.  
  87.                                                                 Page  3
  88.  
  89.  
  90.       Command Mode Parameters
  91.       -----------------------
  92.  
  93.       PALERT allows several command parameter switches to be specified
  94.       to customize the process.  All these parameters are optional.
  95.       The command format and switch parameters are described below.  A
  96.       quick review of command parameters is always available by
  97.       entering the PALERT command with the /H parameter.
  98.  
  99.  
  100.       COMMAND FORMAT:
  101.  
  102.       PALERT [drive:]    [ (/ switches) ]
  103.  
  104.  
  105.       [drive:]  If desired you may specify the drive where space
  106.                 is to be checked.  If the drive letter is not
  107.                 specified, the current defualt drive is checked.
  108.  
  109.  
  110.       /Wppp     Warn the user and set DOS ERRORLEVEL flag if the
  111.                 percentage of free disk space is less than the
  112.                 ppp value specified.
  113.  
  114.                 /W5 indicates to warn user if less than 5 percent
  115.                 of disk space is free.
  116.  
  117.  
  118.       /Bbbbb    Warn the user and set DOS ERRORLEVEL flag if the
  119.                 number of kilobytes of free disk space is less than
  120.                 the bbbb value specified.  The maximum value of
  121.                 bbbb is 32767.
  122.  
  123.                 /B3000 indicates to warn the user if less than
  124.                 3,000,000 characters of disk free space exist.
  125.  
  126.  
  127.       /N        A scale that shows used disk space is normally
  128.                 shown to the user each time PALERT is run.  To
  129.                 prevent the scale from being displayed, enter the
  130.                 /N parameter.
  131.  
  132.  
  133.       /M        Messages are normally shown to indicate the Total,
  134.                 Used, and Free disk space.  If these messages are
  135.                 not normally wanted, enter the /M parameter.  Then
  136.                 they will only be issued when the user is warned.
  137.                                                                 Page  4
  138.  
  139.  
  140.       /P        After the user is warned of insufficient disk space,
  141.                 PALERT will pause to make sure the user is aware
  142.                 of the situation.  To avoid this pause enter /P.
  143.  
  144.  
  145.       /S        When PALERT detects insufficient disk space it
  146.                 sounds an alert to the user.  To avoid this noise
  147.                 specify the /S parameter.
  148.  
  149.  
  150.       /C        Each time PALERT is run it reminds the user that
  151.                 HELP is available by entering the /H parameter.  To
  152.                 avoid this message enter /C.
  153.  
  154.  
  155.       /H        PALERT contains internal help that is available at
  156.                 any time by using the /H parameter.
  157.  
  158.                                                                 Page  5
  159.  
  160.  
  161.       Examples:
  162.  
  163.       1.  Warn user when less than 1,000,000 characters of disk
  164.           space is available.
  165.  
  166.               ===> PALERT C: /B1000 /C
  167.  
  168.  
  169.       2.  Warn user when less than 5 percent of disk space is
  170.           available.
  171.  
  172.               ===> PALERT C: /W5 /C
  173.  
  174.  
  175.       3.  DOS batch file that will check disk space each time
  176.           the LOTUS command is entered.  If the desired disk
  177.           space is not available stop the command.
  178.  
  179.             PALERT /b2000/m
  180.             if errorlevel 1 goto error
  181.             LOTUS
  182.             goto end
  183.             :error
  184.             ECHO command terminated due to insufficient disk space
  185.             :end
  186.  
  187.           This sample DOS batch file may be found in the .ARC file
  188.           that contains this program.  Name=PA123.BAT.
  189.  
  190.                                                                 Page  6
  191.  
  192.  
  193.       Registering PALERT
  194.       ------------------
  195.  
  196.       PALERT is distributed under the Shareware concept.  This makes it
  197.       available for anyone to try without obligation.  If you decide it
  198.       is useful and want to keep it, I ask that you register your use
  199.       of it.  This will allow for continued support and maintenance of
  200.       the program and will help to encourage that more quality software
  201.       be made available through this channel.   We require all
  202.       corporate and government users of this utility register their
  203.       copies.
  204.  
  205.       To simply register the program, $10 is requested.  If you would
  206.       like the newest program disk and a copy of the manual send
  207.       $20.  If you would like to register all the Patriquin utilities,
  208.       and receive programs on disk and manuals, send $45.
  209.  
  210.  
  211.       Send registration requests to:
  212.  
  213.                       Norm Patriquin
  214.                       P.O. Box 8308
  215.                       San Bernardino, CA   92412
  216.  
  217.  
  218.       The registration charge is a one time fee that entitles you to
  219.       all future versions of the product.  These may either be obtained
  220.       from normal Shareware sources or directly from me.  Any
  221.       organization ordering more than 100 copies is also entitled to
  222.       telephone support and will be given the technical support number.
  223.  
  224.       Following is a form that may be used to register PALERT.
  225.  
  226.                                                                 Page  7
  227.  
  228.                               PALERT Registration
  229.                                  Version 1.6
  230.  
  231.  
  232.       Please Register PALERT to the following person.  We will use ____
  233.       copies  of  the program and have enclosed $____ for each copy to
  234.       be used.
  235.  
  236.       **************************************************************
  237.  
  238.       _____ Registration only .............................   $10.00
  239.  
  240.       _____ Registration, program disk and manual..........   $20.00
  241.  
  242.       _____ Registration of all Patriquin Utilities with
  243.                program disks and manuals...................   $45.00
  244.  
  245.       _____ Update of newest Patriquin Utility disk with
  246.                manual.  ...................................   $15.00
  247.  
  248.       **************************************************************
  249.  
  250.  
  251.       Name: __________________________________________________
  252.  
  253.       Company: _______________________________________________
  254.  
  255.       Address: _______________________________________________
  256.  
  257.                _______________________________________________
  258.  
  259.       City: ______________________________  State: ___________
  260.  
  261.       Zip:  ______________________
  262.  
  263.       I obtained my copy of PALERT from: ____________________________
  264.  
  265.       If BBS indicate name and number please._________________________
  266.  
  267.       ________________________________________________________________
  268.  
  269.       Please register the software under the following name:
  270.  
  271.       ____________________________________________________
  272.  
  273.               Send to:
  274.                       Norm Patriquin
  275.                       P.O. Box 8308
  276.                       San Bernardino, CA  92412
  277.                                                                 Page  8
  278.                           P A L E R T
  279.  
  280.       Problems and Maintenance
  281.       ------------------------
  282.  
  283.       I welcome all comments or enhancement suggestions. Please
  284.       document each item clearly and provide printed examples if
  285.       possible.  Please be sure to include this form with all requests,
  286.       it will help to make sure we can provide you with the best
  287.       possible service.
  288.  
  289.  
  290.       Name: __________________________________________________________
  291.  
  292.       Company: _______________________________________________________
  293.  
  294.       Address: _______________________________________________________
  295.  
  296.                _______________________________________________________
  297.  
  298.       City: __________________________________  State: _______________
  299.  
  300.       Zip: ______________________________
  301.  
  302.       Telephone: _______ / ________________________ (Home / Work)
  303.  
  304.  
  305.       Date: _________________________
  306.  
  307.       Description of problem or enhancement:
  308.  
  309.       ________________________________________________________________
  310.  
  311.       ________________________________________________________________
  312.  
  313.       ________________________________________________________________
  314.  
  315.       ________________________________________________________________
  316.  
  317.  
  318.       Suggested solution:
  319.  
  320.       ________________________________________________________________
  321.  
  322.       ________________________________________________________________
  323.                                                                 Page  9
  324.  
  325.       Program Maintenance:
  326.       --------------------
  327.  
  328.       Version 1.0     August 22, 1986
  329.  
  330.       Version 1.6     January 17, 1987
  331.                         --  Problem with large capacity disks printing
  332.                             incorrect space used percent.
  333.  
  334.  
  335.  
  336.       -----------------------------------------------------------------
  337.  
  338.  
  339.  
  340.       Other Patriquin Utilities:
  341.       --------------------------
  342.  
  343.       PSEARCH  --  Extensive file find and Text search capabilities in
  344.                 a menu driven environment.
  345.  
  346.       PCOPY/PMOVE  --  Complete file copy.move utility that prevents
  347.                 users from accidently losing files by using DOS COPY.
  348.                 Fast file movers are intelligent and move files to
  349.                 different hard disk directories without moving data.
  350.  
  351.       PTOUCH  --  Set date and time values on files specified
  352.                 through command parameters.
  353.  
  354.       PALERT  --  Warn users of insufficient disk space before it
  355.                 causes them problems.
  356.  
  357.       PDAILY  --  Perform any command or batch function only once
  358.                   per day.  Use in AUTOEXEC.BAT file.
  359.  
  360.